home *** CD-ROM | disk | FTP | other *** search
/ MacHome 1999 September / MacHome CD-ROM 09-1999.toast / Shareware Utilities / Agax1.2.sea / Agax1.2 / Agax Manual next >
Text File  |  1999-06-14  |  10KB  |  198 lines
  1.                                 Agax Manual
  2.  
  3. ----------------------------------------------------------------------------
  4.  
  5. Agax is currently at version 1.2. If you want you can see the change
  6. history. If you already know how to use Agax and are having problems with
  7. it, then take a look at the FAQ section at the bottom.
  8.  
  9. Agax
  10.  
  11. Agax is an antivirus application. It scans your disks and files for viruses.
  12. It also contains Defender, which is an antivirus extension. Both of these
  13. use Additives to discover and (in the case of Agax) repair infected files.
  14. Additives are stored in the folder 'Additives' in the same folder as Agax.
  15.  
  16. The main window of Agax has the title 'Log'. It records Agax's antivirus
  17. activity - in particular reporting the discovery of infected files, and the
  18. success it has in repairing them. You can perform operations on the log with
  19. the File menu.
  20.  
  21. Agax has two menus with identical contents but different titles - the
  22. 'Examine' and 'Repair' menus. These both do the same thing (scan for
  23. viruses), except that 'Repair' will attempt to remove viruses from infected
  24. files, whereas 'Examine' will just report the infection. Some files cannot
  25. be repaired, and you are given the option of deleting these (if the Additive
  26. responsible considers the file a threat) at the end of the scan. Agax
  27. displays a progress bar during its scan of a volume. To stop the scan, click
  28. the close box of the progress bar.
  29.  
  30. The 'Nasties' menu contains a list of the currently installed Additives. You
  31. can view more information about an Additive by selecting it from this menu.
  32. You can change when this Additive is used from the window which results.
  33. There are three checkboxes: 'Examine files for this virus' uses this
  34. Additive when it is examining; 'Repair files with this virus' uses this
  35. Additive when repairing; 'Proactively repel this virus' uses this Additive
  36. in Defender. Changes to the last checkbox will only take effect on restart.
  37.  
  38. These options as recorded in the preferences. When Agax starts up, it checks
  39. to see how the list of Additives has changed from last time. If any are
  40. missing, it will warn you of the fact, and if there are any new ones, it
  41. will ask you what you want to do with them (enable all or disable all). You
  42. can change this later through the information boxes described above. If Agax
  43. can't find its preferences, it tells you and enables all Additives.
  44.  
  45. Defender
  46.  
  47. The only available option in the Edit menu is 'Preferences'. Currently, this
  48. controls only the preferences for Defender. Any changes made here only take
  49. effect on restart. The first checkbox 'Enable Defender' controls whether or
  50. not the Defender extension is installed. If the status of this checkbox has
  51. changed when you close the preferences, Agax will take the appropriate
  52. action (i.e. create or delete Defender in the Extensions folder).
  53.  
  54. When Defender is enabled, you can choose how it protects your computer.
  55. There are currently three types of protection:
  56.  
  57. - 'Examine volumes when mounted'. When a volume is mounted, it is examined.
  58. If a virus is found you are asked to run Agax on the volume. There is a
  59. further option under this: 'Simple examination' or 'Thorough examination'.
  60. 'Simple examination' is quick and will find viruses which always live in the
  61. same place on a volume (such as AutoStart worms ... not that there's an
  62. Additive for these yet). 'Thorough examination' does a complete scan of the
  63. volume, as if it was selected from the 'Examine' menu, but without the
  64. progress bar. As you can imagine this is very slow, so I don't recommend it.
  65.  
  66. (Note: After startup, all volumes except the system volume will be scanned
  67. in the method indicated if volume examination is enabled)
  68.  
  69. - 'Examine applications when launched'. When an application or desk
  70. accessory is launched, it is examined. If a virus is found, the launch is
  71. prevented and you are told that the application is infected. Control Panels
  72. are not examined, as they execute inside the Finder. To catch infected
  73. control panels (not that I know of any) you would have to use the next type
  74. of protection.
  75.  
  76. - 'Examine resource forks when opened'. When a resource fork is opened, it
  77. is examined. If the file is infected, the open is prevented and you are told
  78. that the file is infected. If this type is on as well as the examining
  79. launches type, clean applications will be examined twice (but it doesn't
  80. take long, so don't worry about it too much). When this type is selected,
  81. even the Finder's 'Get Info' command will warn you of infection (for
  82. applications at any rate).
  83.  
  84. Alongside all of these types of protection there is the option to log when
  85. the checks occur. Even if these boxes are unchecked, infections will still
  86. be logged - unchecking them just cuts out the 'Started...'/'Completed ...'
  87. log entries. Warning: Turning this option on for resource forks is a bad
  88. idea - resource forks are opened and closed all the time. It will
  89. significantly slow down your computer, and make the log huge (too big for
  90. SimpleText) very quickly. The log is also useful for determining the virus
  91. causing the infection (without running Agax), as the notification message
  92. does not tell you this information.
  93.  
  94. Defender's log is called 'Defender Log' and stored inside the System folder.
  95.  
  96. Defender too keeps track of which Additives are around - newly discovered
  97. additives are disabled. The Additives which Defender uses are those beside
  98. the last Agax which was run - so make sure you don't use Agax on a server
  99. (actually, I haven't tested this - it might actually mount the server during
  100. startup).
  101.  
  102. Warnings, bugs, etc.
  103.  
  104. Warning: Both Defender and Agax make an attempt to guard against themselves
  105. being infected. Thus you shouldn't fiddle with them - in particular, don't
  106. unlock Agax, and don't change its memory allocation. This will likely be
  107. improved and extended to Additives in the near future.
  108.  
  109. Agax replaces Antigax and GAx Defender - you should delete these and use
  110. Agax and Defender instead.
  111.  
  112. System Requirements
  113.  
  114. Theoretically, Agax should work from System 7.0 up, however Defender only
  115. works from System 7.5 up. The current version has only been tested on System
  116. 8.0 and 8.1 (that should probably be MacOS 8.0 ... ), so I really don't know
  117. about anything other than those.
  118.  
  119. Special Help Sections (FAQs)
  120.  
  121. I just expanded Agax and ran it, and it says it's been tampered with! I sure
  122. didn't touch it - what gives?
  123.  
  124. This error usually results when Agax itself has become infected. It will
  125. refuse to run if that happens, because the virus might re-infect files as
  126. fast as Agax repaired them.
  127.  
  128. If it was something you did (e.g. modified it with ResEdit, changed its
  129. memory requirements, etc.) then you should replace the modified Agax with a
  130. freshly expanded version.
  131.  
  132. If it was due to a virus however, then it is more than likely that this
  133. virus is in RAM (and therefore practically impossible to remove without
  134. restarting), and would infect Agax again if you re-expanded it straight
  135. away. So I suggest you do the following:
  136.  
  137.    * Delete the Agax application, but keep the Stuffit archive handy.
  138.    * Restart your computer from your System CD (e.g. the Mac OS 8 CD), or
  139.      some other guaranteed virus-free System Folder.
  140.    * Expand Agax.
  141.    * Launch Agax.
  142.  
  143. If this still doesn't work (very unlikely), then try repeating the
  144. procedure, but locking the Agax application after you expand it and before
  145. you launch it.
  146.  
  147. If Agax does not find any viruses, then it is probable that it was infected
  148. by a previously unknown virus. If this happens, then please get in touch
  149. with me!
  150.  
  151. Originally I intended to keep Agax locked, so viruses would have more
  152. difficulty infecting it, but in the initial release I neglected to do this.
  153. This turned out to be far better for everyone, because Agax inadvertently
  154. found some new viruses when they infected it - so I've decided to keep it
  155. unlocked by default. If you wish to lock it however, then by all means go
  156. ahead, but you will forgo that extra level of protection.
  157.  
  158. I just installed a new Additive, and choose the 'Verify over Internet'
  159. option, and this huge dialogue came up with three lists in it. What does it
  160. all mean, and should I worry?
  161.  
  162. OK, this is new in Agax v1.2. The list on the left shows the latest versions
  163. of Additives that the Agax web server knows about. Anyone is free to write
  164. their own Additive, but it won't appear on that list unless they tell me
  165. about it. Also, new Additives will appear in this list when they are
  166. released, so you can check here for updates instead of going to the web page
  167. if you want to.
  168.  
  169. The other two lists contain Additives sitting in the Additives folder on
  170. your computer that Agax is currently using. If the server knows about the
  171. Additive (of that version), then it goes into the list on the left (i.e. the
  172. middle of three). If the server doesn't know about it then it goes into the
  173. list on the right. In addition to this each Additive has a tick or a cross
  174. in front of it. This only indicates whether or not you've currently got it
  175. enabled - nothing more. You can enable or disable all the Additives in
  176. either list by using the radio buttons alone. 'Leave' means they are left as
  177. they appear in the list.
  178.  
  179. All of my Additives will appear in the Master List and be verified in the
  180. middle list. It's only Additives written by other people that could
  181. legitimately end up in the third list. You should be very suspicious of any
  182. Additives unexpectedly turning up in that list, especially if they claim to
  183. have come from me.
  184.  
  185. All of this is to ensure that someone won't make an Agax Additive that is a
  186. virus, especially if they claim that I've written it. In general you should
  187. need a good reason for trusting an Additive that the server doesn't.
  188.  
  189. Disclaimer
  190.  
  191. #include <std_disclaimer.h>
  192.  
  193.  
  194. {P^/
  195. 14/6/1999
  196. John Dalgliesh
  197.  
  198.